home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 May / Software of the Month Club 1996 May.iso / mac / ISO9660 / ZIPFILES / MAGPS311.ZIP / USE.DOC < prev   
Encoding:
Text File  |  1996-01-28  |  12.0 KB  |  210 lines
  1. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  2. ▒▒                                                                           ▒▒
  3. ▒▒     PICTOPS (PICture TO PostScript file) power conversion program         ▒▒
  4. ▒▒                     All Rights Reserved                                   ▒▒
  5. ▒▒                Version 3.11 Revision 24/01/96                             ▒▒
  6. ▒▒         Copyright (C) 1995-1996 by TerSoftWare DNP IHEP Russia            ▒▒
  7. ▒▒                     Created by Igor L. Vassiliev                          ▒▒
  8. ▒▒ Author may be reached as:                                                 ▒▒
  9. ▒▒                           E-mail: vasiliev_i@mx.ihep.su                   ▒▒
  10. ▒▒   ╔═══════╗ ╔═══════╗        Fax: (007)(095)-230-2337                     ▒▒
  11. ▒▒   ║       ║ ║                     Department Of Neutrino Physics          ▒▒
  12. ▒▒   ║       ║ ║                     To: Igor L. Vassiliev                   ▒▒
  13. ▒▒   ║       ║ ╚═══════╗       Mail: P.O.Box 142284 Russia                   ▒▒
  14. ▒▒   ╠═══════╜         ║             Moscow region, Protvino                 ▒▒
  15. ▒▒   ║  ┌┐┌─           ║             Lesnoj boulvar 12-74                    ▒▒
  16. ▒▒   ║ ─┼┘└─   ╚═══════╝             To: Igor L. Vassiliev                   ▒▒
  17. ▒▒                                                                           ▒▒
  18. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  19.  
  20.                          *PURPOSE*
  21. To convert image files to compressed PostScript-2,1 file format
  22. (PostScript is a trademark of Adobe Systems, Incorporated.)
  23.  
  24.                          *FEATURES*
  25. PICTOPS V3.11 is power conversion program to convert image files
  26. to COLOR, GRAY and B&W PostScript file format. The following the base
  27. of PostScript implementations are used.
  28. I)  Involved PostScript compression.
  29. PICTOPS will compress (PostScript program will decompress) image data
  30. by CCITTFaxEncode, LZWEncode or RunLengthEncode and then by ASCIIHexEncode
  31. or ASCII85Encode filters. Also, it is possible to create BINARY PostScript
  32. file without ASCIIHex or ASCII85 encoders (PostScript file will be not
  33. ASCII-printable in this case). Output from PICTOPS may have much small
  34. size than standard PostScript outs from other programs with simple Level-1.
  35. In the most cases, PKZIP or ARJ cannot compress PostScript out from
  36. PICTOPS more than 5-20% !
  37. II) Involved PostScript colour implementations.
  38. Supported simple 5-operand form of the (gray)image and 7-operand form of
  39. colorimage. Also, for index modes, image dictionaries which are
  40. a more general means for specifying parameters to the image operator are used.
  41. The image operator has a 1-operand form in which the operand is an image
  42. dictionary. In case with image dictionary setcolorspace operator will be used
  43. and data into the PostScript file will be presented as color indexes with
  44. color palette.
  45. Image sample may consist of 1,4 or 8 bits per component (24 bits images,
  46. presented as RGB - 8 bits per component). Image source data may be provided by
  47. string,procedure or filter.
  48.                          *NOTE*
  49. If PostScript device HAVE NOT ANY IMPLEMENTATIONS OF LEVEL-2, then the program
  50. automatically will be running as PostScript LEVEL-1 !
  51.  
  52.                       *REQUIREMENTS*
  53. Program requires an IBM PC/AT/fully compatible computer, MS-DOS 3.0 or greater
  54. and from 180 to 450 Kb of free conventional memory.
  55. Any Intel processor from i86(88).But 40MHz and better is recommended for speed.
  56. Program will running without any XMS/EMS.
  57.  
  58.                          *USAGE*
  59. Usage: pictops [options] [d:path]image-file [[d:path][out-file.ps]]
  60.  
  61.                          *IMPORT*
  62.  BMP - MS-Windows 3.1 Bitmap Format. BMP is the native bitmap file
  63.        format of the Microsoft Windows environment.
  64.        Supported the all kind of this format (BI_RGB,BI_RLE4 & BI_RLE8)
  65.        Except 24-bits files
  66.  GIF - Graphics Interchange Format (tm)
  67.        Supported GIF87a and GIF89a modifications
  68.  ICO - MS-Windows Icon Format
  69.  PCX - ZSoft Paint. Supported the all kind of this format
  70.        Except 24-bits files
  71.  PBM - Portable Bitmap
  72.  PGM - Portable Greymap
  73.  PPM - Portable Pixmap file format
  74.        (Extended Portable Bitmap Utilities (PBMPLUS))
  75.  RLE - The same that compressed BMP
  76.  TGA - Truevision (Targa) File Format. TGA is the native file format
  77.        of the Truevision Incorporated
  78.        Supported types: 1,2,3,9,10,11
  79. *NOTE* Import file may have no extention. File type will be detected
  80.        automatically.
  81.  
  82.                          *EXPORT*
  83. Color,Gray or B&W compressed or not PostScript file within Level-1 and Level-2.
  84. *NOTE* If name PostScript file-out is not specified and /sXXXX option is
  85. absent,then the file type will be as PostScript with name [d:path]image-file.ps
  86.  
  87.                          *OPTIONS*
  88. The all command options must be preceded either '-' or '/' character.
  89. The options are described as follows:
  90. /zFAX  - Import image data will be encoded at first by means of
  91.          PostScript FAX (Modified Huffman compression. Group 3,1-D) filter and
  92.          then through PostScript ASCII85Encode filter, which will be extend
  93.          binary data to ASCII printable chars as 4:5
  94.          *NOTE* In most cases, effect from compression will be for mono
  95.                 image only !
  96.          *NOTE* If width of image is too large, PostScript error message
  97.                 may be received: /rangecheck in --.filter_CCITTFaxDecode--
  98. /zLZW  - Import image data will be encoded at first by means of
  99.          PostScript LZW (Lempel-Ziv-Welch) filter and then
  100.          through PostScript ASCII85Encode filter, which will be extend
  101.          binary data to ASCII printable chars as 4:5
  102. /zRLE  - Import image data will be encoded at first by means of
  103.          PostScript RLE (Run-Length-Encode) filter and then
  104.          through PostScript ASCII85Encode filter, which will be extend
  105.          binary data to ASCII printable chars as 4:5
  106. /zWOC  - Without PostScript compression (by default)
  107.          Import image data will be encoded through ASCIIHexEncode
  108.          filter e.g. each binary byte will be presented by two ASCII
  109.          printable hex-digits. Extention is as 1:2
  110. /sPS   - Set output as PostScript (by default)
  111. /sEPS  - Set output as Encapsulated PostScript
  112. /sEPSI - Set output as Encapsulated PostScript Interchange (EPS with preview)
  113.          *NOTE* Option /sEPSI is not available in version 3.xx
  114. /L2    - To force PostScript Level-2 only. Program will NOT detect in
  115.          PostScript device whether there is Level-2 or not.
  116. /g     - To force grayscale PostScript output (by default)
  117. /c     - To force color PostScript output
  118. /i     - Background inversion (if possible)
  119. /b     - To force binary PostScript out. (ASCIIHexEncode or ASCII85Encode
  120.          filters will be not implemented)
  121.          *NOTE* Output PostScript file will be NOT ASCII printable !
  122. /A4    - To force PostScript out to scale to A4 format 210x279mm (Really is
  123.          210-2*18 & 279-2*25. 18mm from left&right and 25mm from up&down edges)
  124.          Default is - default size of picture.
  125.          *NOTE* Available with /sPS option only !
  126.          *NOTE* If image size exceed size A4 either by width or by height or
  127.                 both, A4 format will be done automatically.
  128. /R     - PostScript out will be 90-rotated (Landscape). Default is Portrait.
  129.          *NOTE* Available with /sPS option only !
  130.          *NOTE* If used together with /A4 options, so the rotate will be
  131.                 done at first then scale.
  132. /o     - Overwrite PostScript output if it exists without prompt.
  133. /t     - Show time of PostScript encoding
  134. /cr    - Show compress ratio
  135. /nw    - Warning messages turn off
  136. /n=x   - Ico-Image number (May be from 1 to 7)
  137. /h,?   - this Help
  138.  
  139.                          *USAGE EXAMPLE*
  140. 1) D:\>pictops sample
  141.    Image file 'sample' will be translated into the grayscale PostScript
  142.    file 'sample.ps' with no PostScript compression, picture is centered,
  143.    size default.
  144.    (Equivalent is: D:\>pictops /zWOC /sPS /g sample sample.ps)
  145. 2) D:\>pictops /zRLE /R /A4 /c /b d:\tmp1\sample d:\tmp2\*
  146.    Image file 'd:\tmp1\sample' will be translated into the binary, color
  147.    PostScript file 'd:\tmp2\sample.ps' with PostScript RLE compression,
  148.    picture 90-rotated and scaled to A4.
  149. 3) D:\>pictops /L2 /sEPS d:\tmp1\sample.pcx
  150.    Image file 'd:\tmp1\sample.pcx' will be translated into the grayscale
  151.    Encapsulated PostScript file 'd:\tmp1\sample.eps' without PostScript
  152.    compression, with Level-2 codes only, picture is centered, size default.
  153.  
  154.                     *RECOMENDATIONS TO USE*
  155. Although PICTOPS have enough big collection of warning-messages about
  156. suspicion in corrupted image files, nevertheless it is recomended before to run
  157. output file on the PostScript printer, BE SURE that your PostScript file have
  158. valid format. For example, it may be done by GS.EXE or by any other viewer.
  159.  
  160.                          *NOTE*
  161. Ghostscript Version 54.0 Rev 2.6.1. 05/28/93 (may be and other versions)
  162. has some errors in PostScript Filters. Some detected errors:
  163. ╔═══════════════╦════════╦════════════════════════════════════════════════════╗
  164. ║  Filter name  ║ Errors ║             Description                            ║
  165. ╠═══════════════╬════════╬════════════════════════════════════════════════════╣
  166. ║               ║        ║ Sometimes it don't read terminator sign '>' after  ║
  167. ║ASCIIHexDecode ║  YES   ║ data. Without '>' always is okay.                  ║
  168. ║               ║        ║ (PICTOPS don't write this sign)                    ║
  169. ╟───────────────╫────────╫────────────────────────────────────────────────────╢
  170. ║ASCII85Decode  ║   NO   ║ No errors detected                                 ║
  171. ╫───────────────╫────────╫────────────────────────────────────────────────────╢
  172. ║CCITTFaxDecode ║   NO   ║ No errors detected (Group 3,1-D)                   ║
  173. ╟───────────────╫────────╫────────────────────────────────────────────────────╢
  174. ║               ║        ║ Sometimes, data from file are not reading to end   ║
  175. ║LZWDecode      ║  YES   ║ calling error: /undefined in ABC...                ║
  176. ║               ║        ║ Where ABC... are data from PS-file. More often this║
  177. ║               ║        ║ take place upon monotonous and continuous images.  ║
  178. ╟───────────────╫────────╫────────────────────────────────────────────────────╢
  179. ║RunLengthDecode║   NO   ║ No errors detected                                 ║
  180. ╚═══════════════╩════════╩════════════════════════════════════════════════════╝
  181. Your action in error cases:
  182. 1) EITHER
  183.    Remove comment (percent sign) in the line:
  184.    %/Check_Filter false def
  185.    In this case PostScript-run will be with no Filters.
  186.    (File must be done without /b and /L2 options, of course !)
  187.    OR
  188. 2) Do make run PICTOPS with other filter
  189.  
  190.                          *REGISTRATION*
  191. PICTOPS is inexpensive shareware. If you find that PICTOPS is useful and
  192. continue using it after a trial period of 20 days, you are encouraged to pay
  193. a small registration fee. When you register, you will receive the last version
  194. of PICTOPS and your registration number. Registration entitles you continue
  195. using the current version and all future versions. The registration number
  196. will remove any limitation functions in the unregistered version of the
  197. current and the future releases.
  198. To register your copy of PICTOPS, please, send me your request to:
  199. E-mail: vasiliev_i@mx.ihep.su
  200. Unregistered version has ONE limitation - the maximum resolution of an input
  201. image-file is 640x480. The limitation is removed in the registered version.
  202.  
  203. ╔═════════════════════════════════════════════════════════════════════════════╗
  204. ║                          *WARNING*                                          ║
  205. ║ YOU ARE USING PICTOPS AT YOUR OWN RISK ! THE AUTHOR (Igor L. Vassiliev)     ║
  206. ║ IS NOT RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF PICTOPS OR BY THE    ║
  207. ║ INABILITY TO USE PICTOPS. IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T   ║
  208. ║ ACCEPT THIS, THEN DO NOT USE PICTOPS !                                      ║
  209. ╚═════════════════════════════════════════════════════════════════════════════╝
  210.